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TRSDRAW Version 2.1 Documentation 



TRSDRAW is 
Model 4 with 
run on other 
of 6 programs 

TRSDRW.BIN - 



FGDUMP.BIN 

FSRSTR.BIN 
TRSLD.BIN 

TR5SV.BIN 
TRSQV.BIN 



a powerful, full-screen graphics editing package for the I RS-SU 
the Radio Shack High-Res Graphic**, board. This program will not 
graphic boards (such as Micro-Labs). Version 2.1 needs a total 
to operate. They sre: 
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the TRSDRAW program. It is a BASIC program stored in 
.sad format (not ASCII), therefore the .BIN extension, 
this file to TRSDRAW/BAS. 

mps'the graphics screen to a BANK, and is required for 
the "Whoops" feature. 12SK is required. Rename this 

the compliment of FGDUMP.BIN, and requires 128K. Rename 
le to FBRSTR/CMD. 
lows TRSDRAW to load /HR6 files to be edited. 1 he^GLDAD 

cannot be used because of the way TRSDRAW operates, 
this file to TRSLOAD/CMD. 

lows TRSDRAW to save /MRS -fil-es. -6SAVE cannot be used, 
this file to TRSSAVE/CMD. 
lows TRSDRAW to "overlay" a /HRG file onto the current 

without erasing what is on the current screen. Rename 
le to TRSOVLY/CMD. 



Future versions of TRSDRAW may need more, or fewer separate f Ues. please 
make sure that you have the proper documentation for the version of TRSDRAW 
you are using. If you do not wish to use the features that require these 
files, you do not need to get them. For instance, if you have on 1/ 64k, you 
shouldn't bother getting FGDUMP.BIN or FGRSTR.BIN. TRSDRAW will test for the 
presence of the files on disk, and will not "crash" if they are not there. 

To run TRSDRAW from TRSDOS Ready, enter "BASICS TRSDRAW/BAS" and press 
•-'enter-- After BASICG loads, TRSDRAW will display its heading (including 
varsion'number), and initialize itself. The initialization procass takes 
about 15 seconds. During this time, you will receive information about the 
buffers you have available for the "Whoops" command, and will be asked if you 
wish to clear the buffers. If you have not used TRSDRAW prior to this and 
have not "Saved" a screen in one of these buffers, answer "Yes . You will 
then be in the Editing mode. 

Note that TRSDRAW needs a lot of memory to operate. You should have a 
minimum of FILTERS and such stored in High Memory. Use the MEMORY command to 
see the current setting of HIGH*. HIGH* should be ABOVE x'FSOMor TRSDRAW 
to operate properly. To be safest, try to keep HIGH* above x FBOO . 



HELP 

~~A~menu of available commands is available at anytime you are in the 
"command" mode by pressing <H> . The menu displays all of the Commands 
available in the top portion of the menu (notice that many keys are -served 
for future use). All of the Immedeate Actions ^rB in the bottom part of the 
m*»nu. The "Commands" may only be pressed in the "Command Mode" — when you 
see a sinole blinking diamond on the screen. The "Immdedate Actions can be 
pressed at ANY time, and they will take effect. If you have any doubt as to 
which mode you are in, press the <shif t><clear> keys together. This will 
Al WAYS oet vou back to the command mode. 

From this menu, you may either select a command by pressing the proper key, 
or may return to the editing screen by pressing either <H> again, or just 
pressing <Enter>. . . . 



CURSOR MOVEMENT 

The arrow keys move the cursor (the blinking diamond) around the screen in 
the direction indicated. The number keys (use the keypad) move the cursor as 
well, allowing movement diagonally (the 8 key is "UP", the 1 key is "down and 
to the left", "etc). Use which ever method is more convenient. Note that the 
Shifted Arrow keys will move the cursor to the margin in the indicated 
direction . 

Pressing the <Space> bar toggles the status of the PEN. When the pen is 
"UP", you can move the cursor around the screen without distroying anything 
underneath the cursor. When the pen is "DOWN", the cursor will leave a 
"trail" in the current color (black or white). In this way, you can draw 
..free-hand" on the screen. Pressing <shif t><Clear> will always LIFT the pen. 

To change the speed, or step rate, of the cursor, press the shifted number 
keys. For instance, <Shift><8> will set a step size of 8 dots. This allows 
step sizes ranging from 1 to 9. If you want a step size of 10, press the <0> 
key, without the <shift> (<shift><0> is the command for CAPS lock). By 
pressing the <;> key, you can double the current step size, allowing step 
sizes of up to 20. Pressing <-> returns the step size to normal. There sre 
2 special keys: <F1> will set a single step size (just as <shift><l>) to 
allow for aligning thinqs, and <F2> will set a step size of 20 ( just as <0> 
followed by <;> ), to quickly move across the screen. These keys are for 
convenience only, and are no different from the other ways of getting these 
step sizes. 

The <F3> command will toggle between the "Double X" mode and the "Single X" 
mode. When in the Double X mode, the movement of the cursor in the X 
direction (left to right) is TWICE the movement of the cursor in the Y 
direction (up and down). The reason for this is because each dot on the 
screen is twice as HIBH as it is WIDE. With the Double X mode selected, 
moving diagonally (using the keypad to move the cursor) will move equal 
distances in both the X and Y directions. If the Single X mode is selected 
(the default), the distance the cursor travels in the X direction will be 
half what it travels in the Y direction. 

REMEMBERING POINTS 



It is possible to tell TRSDRAW to "remember" certain points, or positions 
on the screen. TRSDRAW can remember up to 26 different points, labled <A> 
through <Z>. Pressing the <,> key followed by a "name" of <A>-<Z>, will 
remember the current location of the cursor. Pressing the <-> key, followed 
by a name of <A> to <Z> will cause the cursor to return to that point. This 
gives you quick and accurate movement about the screen. If you press 
<-><name>, and no point has been stored under that name, nothing will 
happen. Several of the keys have been pre-defined: 

<.XT> - moves the cursor to the <T>op center of the screen. 

<.XB> - moves- the cursor to the <B>ottom center. 

<.XR> - moves the cursor to the center of the <R>ight side of the screen. 

<,XL> - moves the cursor to the center of the <L>eft side. 

<.XN> - moves to the center of the uppei — left quarter of the screen. 

("north") 

<.XS> - moves to the center of the lower-left quarter of the screen. 

( "south" ) 

<.XE> - moves to the center of the uppet — right quarter of the screen. 

( "east" ) 

<-XW> - moves to the center of ten lower-right quarter of the screen. 

( "west" ) 

<.XC> - moves to the <C>enter of the screen. 

Note that ANY key will be accepted, not just <A>— <Z>. However, the key you 
press is translated into a number between 1 and 26, so several keys may 
"hash" to the same key. In other words, unless you are sure of what you are 
doing, stay with the keys <A> to <Z>. 

Also note that with the pen down, a line will be drawn between the old 
cursor 

location, and the new one just "returned" to. If you do not want lines drawn 
around the screen in this fashion, make sure the pen is up when moving about 
the screen. 

COLOR 



To change the color you are working in, press the <@> key. This toggles 
the current color between BLACK and WHITE. The status of the color key 
affects many things, not just the color you are currently drawing in. For 
instance, the <N>ew screen command will clear the screen to the color that is 
OPPOSITE to the current one. If you have BLACK selected as the current color 
and clear the screen with the <N> command, the screen will be cleared to 
WHITE. Many other commands operate in this same way. 

THE INFORMATION LINE 



Pressing </> (or you can think of it as <?>) will display a brief 
information line at the bottom of the screen. The information displayed 
includes the current location of the cursor, the current color, whether the 
PEN is up or down, whether you are in the Double or Single X mode, the 
current step size, and the current file name you are editing. Pressing </> 
or <enter> will restore the screen and do nothing, or you may just press any 
Command or Immediate key to continue editing. . 



BOXES 

Pressing <B> enters the "BOX" mods. A "marker" (an 'X') is placed at the 
current cursor position, and a set of three "corner" cursors then appear. You 
can adjust the size of the BOX by moveing the cursors with the cursor 
movement keys (even "remembering" points). You are actually moving the 
cursor diagonal to the Mark; TRSDRAW is providing the other two cursors to 
aid in aligning the sides of the box. 

When you have the box as you want it, pressing <enter) will draw the box in 
the current color, and move the marker the the current cursor location. You 
may then proceed to make another box. If you press <B> again, instead of 
enter, the box will be drawn, but the marker will remain where it was. To 
escape the BOX mode and return to the command mode, press <shif t><clear> . 

CIRCLES 

Pressing <C> will enter the "CIRCLE" mode. The center of the circle will 
be at the current cursor location, and four cursors will appear, one each at 
the top, bottom, left and right sides of where the circle will be drawn. You 
do not have the normal cursor motion keys available to you in this mode. The 
keys you use to make a circle ars; 

<up arrow) - make the circle grow larger. 

<down arrow) - make the circle smaller. 

<left arrow) - shrink in the sides of the circle (skinny ellipse). 

<right arrow) - expand the sides of the circle (fat ellipse). 

<shift><up arrow) - Return an ellipse to a circle. 

<shift)<down arrow) - shrink the circle back to the starting size. 

You may then press <enter) or <C) to draw the circle. There is no 
difference between them. You can then move the cursors to draw a new circle, 
or press <shif tXclear) to go back to the command mode. Note that if the 
center of the circle is at the EDSE of the screen, you may not be able to see 
the cursors. The circle command functions properly, but the cursors may not 
be visible. 

DISK I/O 



Pressing <D) takes you to the Disk Access portion of TRSDRAW. You can 
select to set the Command Drive (the drive which stores the alternate TRSDRAW 
modules, like TRSLOAD/CMD) , or the Data Drive (the drive which will store 
the screens you wish to edit) . You can also select to SAVE the current 
screen to disk, Load a new screen from disk, or Overlay the current screen 
with a screen from disk. If you select Load, Save or Overlay, a directory of 
all '/HRG' files will appear and you will be promped to enter the filename of 
the one you wish to load, or a new name for one you wish to save. Pressing 
<shif tXclear) will take you back to the menu if you do not wish to enter a 
filename. 

Note that TRSDRAW will automatically supply the drive number (if a DATA 
drive is set) and an extention of /HRS. You may over-ride these defaults by 
simply typing the extension and/or drive number you wish as part of the 
filename. 

TRSDRAW also will automatically supply the last filename successfully used in s 
load or save if you press 'ENTER) with out typing anything. If no previous 
default has been established, the filename "NONAME/HRB" will be used. If you 
are SAVING a file, and the filename you give already exists, you will be asked 
if you wish to REPLACE the file. Type 'Y - to replace the file, 'N' to return 
qo the directory. 

If you are selecting a Command or Data drive, enter the drive number 
(values through 7 are accepted). If you wish TRSDRAW to search all drives 
(the default), just press <enter) or <A) for "all". 

ERASER 



Pressing <E) calls up the eraser. The eraser "erases" in the opposite 
color to the one that is currently selected. If White is the current color, 
the eraser will erase with Black, and vice-versa. You can move the eraser 
around the screen without erasing anything, just like the "regular" 
cursor. Use the <space bar) to start eraseing (just like the PEN 
command). The space bar will toggle between erase, and no-erase 
modes. Pressing <shif tXclear) will return to the normal command mode. 

Note that the eraser is a "square" that is 8x4 dots. If you select the 
Double X mode, and a step size of 4, the eraser will erase contiguous areas of 
the screen. For small, or detailed erasures, select a step size of 1. If you 
use larger step sizes, the eraser will "miss" areas of the screen. 

FILLED BOXES 

This command is exactly like the <B)ox command, except the boxes sre filled 
(solid color) . 

SET BLOCK 

It is possible to save small sections of the screen onto disk. This is the 
command that allows you to retrieve them. A directory of all '/BLK' files 
will be displayed, and you will be prompted to enter the filename of the 
block you wish to use. Pressing <shif tXclear) will escape back to the 
command mode. After loading the requested block, you will be put in the 
<M)ove/copy mode to allow you to put the block anywhere you wish. (see the 
MOVE command). If you are getting a block that has just been put, just press 
<Enter) to the filename prompt. The last used filename will be used. If 
there is no previous filename, the name NONAME/BLK will be used. 



INVERT SCREEN 



"pressing the <I> key will cause the entire screen to be "reversed" or 
"inverted." What ever was black is now white, and vice-versa. You are 
returned to the command mode automatically. 



- ; , . . •■ LINES 

"rrsssino the <L> key enters the LINE mode. A marker (an *X') will appear 
at the current cursor location, and you will be able to move the diamond 
cursor around the screen to specify the other endpoint of the line. Pressing 
'ENTER N > will draw the line in the current color, move the marker to the 
-•:••■•" . current cursor location, and allow you to continue drawing lines. If you 

press <L> instead of <enter>, the line will be drawn, but the marker will not 
be moved. Press <shif t><clear> to escape to the command mode. , 

-.-.-™*-"— ' - MOVING AND COPYING 

- "• == Pressing _ <Mrenters the MOVE mode. You create a "box" around the area you 

want to move, and press <ENTER> . If the area you are trying to move is too 
large, TRSDRAW will beep, and allow you to try a smaller area. With this . 
version, you are limited to a fairly small area. Future versions will key the 
maximum' size of the area to available memory, and will thus allow larger areas 
(assuming no HIGH memory is used). _ : 

Afte- pressing enter, you can move the "box" around the screen using the 
cursor movement keys, 'if you press <ENTER> at any time the image you 
"nicked up" (copied) will be "put down" at the current location EXACTLY as it 
W as picked up. There are several other choices in "putting down" the image: 
<I> - puts down the "inverse" of the image. 

-'A'-- - "Ands" the image with what is already on the screen (a point will be 
white if and only if that point is white on the screen AND in the 

<0> - "Sri" the image with what is already on the screen (a point will be 

■*• if either that point is white on the screen OR in the image). This 

option "blends" the image with what is on the screen. 

,. x -> - "exclusive ors" the image with what is already on the screen. Pressing , 
places the image down, and pressing it again will pick it back up (u-=e 
* "this option for "testing" if the image looks good. If not, pressing 
<X> again will remove the image). Also, if you wish to "remove" the 
original, press <X> immediatly after pressing <Enter> ("Picking it up") 

■-■p^ - will "PUT" the image to disk, for use later with the <G>et block 

command. A directory of /BLK files will be listed and you will be 
prompted to select a filename with which to save the block. Press 
<shiftx'clear> to exit without putting the block. If you press <-Enter> 
without typing a filename, the last used filename will be used. If 
there is no previous defalut, the filename "NONAME/BLK" will be used. 
Note that the extensions and drive numbers sre added automatically. 

The image you "picked up" is lost when you exit the <M>ove command with the 
<shif t><clear> key. 

NEW SCREEN 



Pressing the <N> key will clear the screen. If the current color is BLACK, 
the screen will be cleared to WHITE, otherwise it will be cleared to 
BLACK. You must press <ENTER> to actually clear the screen. Pressing any 
other key will cause TRSDRAW to beep, and return to the command mode. This 
is to safeguard against accidental erasure. 

PAINTING 

"""pressing the <P> key will cause a menu of 24 paint tiles to appear. Move 
the flashing cursor to the pattern you wish to paint with, and press 
enter. The screen will be painted with that pattern starting at the current 
cursor locaion. You may paint on Black *0R* White backgrounds. It doesn t 
matter. If you paint White on White, TRSDRAW will actually paint "1 th 
Bl ACk The <P>aint command remembers the last selected pattern, and will 
leave" the paint cursor there for when you next invoke the Paint command. 

QUITTING TRSDRAW 



Pressing <Q> will exit the TRSDRAW program. You must press <enter, to 
actually exit the program. Any other key will cause TRSDRAW to beep and 
return to the command mode. You MUST exit TRSDRAW in this fashion, not just 
by pressing <Break>. You will be returned to TRSDOS. 

SAVING THE SCREEN 

"""preising~the <S> key, followed by either the <F1> or <F2> keys, will save 
the current screen to the corrisponding screen buffer. The available buffers 
are displayed during initialization of the program If you do not have 1.8K, 
or both memory banks are in use, this command will be disabled. it tne 
buffer is unavailable, or you press an incorrect key, TRSDRAW will beep and 
return to the command mode. The screen will not be saved. You may 
substitute the <1> and <2> keys for <F1> and <F2> if you wish. 



TEXT 



"presing <T> will enter the TEXT mode. A text cursor will appear, 
^erything you type will be typed onto the graphics screen. Full w 



and 

wrap-around 
everything you type n±n u= <. r h"=" ^,,--^ w.w v . _,, i- 

is supported. To erase a character, place the cursor over that character, 
and type that character again. _ 

To type in the other three directions (up, down, and upside-down), press 
■•'CLEARS together with the arrow pointing in the proper direction. <CLEAR> 
-'right arrow> will restore normal text. Full wrap-around is supported in all 
modes. You may move the cursor to any location on the screen using the arrow 
keys. Press <shif tXclear) to escape. 

ADDENDUM TO TEXT 

~"~This~version of TRSDRAW has been modified via TRSTEXT2 to use DOTWRITER 
fonts i ns tead of the normal TEXT mode. Wrap-around is no longer supported. 
Also, instead of typing directly onto the graphics screen, you will enter 
your type into a text block. Whan you type <T>ext, you will be asked which 
DOTWRITER font you wish to use, type the name of the font: is, NEW=/Ffi . 
(note- if the extention is /PR, you don't have to type /PR, and if you've 
forgotten which fonts you have, type ? and hit return, and it will tell you 
which fonts you have on all drives, then prompt you for a filename again!) 
Type your text into the block S hit enter. The graphic screen will re-appear 
with a flashing square. Use the arrow keys to position the square where you 
want the text to go, then hit enter. TRSDRAW will then draw the text onto 
the screen, or hit <shif t-clear> to abort the text and return to graphics. 



WHOOPS 

Pressing the <W> key, followed by either the <F1> key or the <F2> key 
restores the corresponding screen buffer. You can use this command to 
recover from mistakes, or to "try out" certain things with out having to 
worry about destroying work that has already been done. The screen will be 
restored to the state it was last <B>aved as. You can have up to 2 screens 
saved at one time. If you saved a screen, Quit TRSDRAW, and re-entered 
TRSDRAW without clearinq the buffers, you can use the Whoops command to get 
the serpen you had back without having to save it to disk. Before you try 
something (like <M>ovina things), always <S>ave the screen, so you can 
<W>hoops if you need to. You may press <1> or <2> inplace of <F1> and <F2> . 

PRINTING THE SCREEN 

TRSDRAW does not currently support a method of printing the graphics screen 
from within the program. This is for the same reason that GLOAD and 6SAVE will 
not load and save TRSDRAW files (the "screen" you are working with is towards 
the true center of the 1024x256 graphics RAM). At present the best method of 
obtaininq a printout is to save the screen to a disk file (with the <D> 
command)^ Save your screen to a buffer (if available, with the <S> command), 
and to <Q>uit TRSDRAW. Then type 'GLOAD filename' to load the graphics screen 
with the file, and use what ever graphics screen print utility you need to get 
a print out. ' You can then get back into TRSDRAW with the command 'BASICG 
TRSDRAW/BAS' . When asked if you wish to clear the buffers, type <N.> for 
ro When you ^re presented with the TRSDRAW screen, type <W> hoops to get the 
<S>aved screen back. This omition will be corrected with the next release of 
TRSDRAW — however, not all printers will be supported. 



w 



ADDENDUM TO PRINTING 

If you SAVE your screen in TRSDRAW as: filename/HR, you can use Mel 
Patrick's HIRES4/CMD to print it. from HIRES4, <G>et 19. 5K HiRes file, and 
<H^ardcopy it, <N>ormal to printer, this will print your file horizontally in 
somewhat squished, but good quality mode. I'm working on getting Mel to write 
a patch for HIRES4 that will cause it to print every line twice, like 
DOTWRITER's dark printing mode, which will give darker print, solid solids, 
and nearly eliminate "jaggies". 



CONCLUSION 

That concludes the discussion of TRSDRAW 2.1. As you can see, TRSDRAW can 
be a very powerful graphics editor. There Are, however, several features 
planned for future versions. These include; 

Editing the Paint Tiles, 

Arcs, 

Flipping sections of the screen (horizontally or vertically), 

Macro Keys, 

Enhancements to <D>isk I/O, <M>ove, -COircle and <T>e;:t, 

Saving of "remembered" points, and Data ?< Command drives, 

and more. 

If you have any suggestions , comments, or (heaven forbid) you find any bugs, 
please taring them to the direct attention of Paul Bradshaw, He can be 
reached on CompuServe by E rn a jU , ■jpfo'^fu.s ection 8 of the TRS80PR0 forum (his PPN 
is [72177,203211), or at 
1372 West Second Ave. 
Columbus OH, 43212 

This program took alot of time and effort to design and create. If you enjoy 
the program, feel free to send a donation of whatever you feel it is worth to 
the above address. Upgrades will appear on CompuServe at regular intervals, 
or as long as a demand exists. (next version planned for a mid-July release, 
depending on response) . 

Thank you for using TRSDRAW, and I hope you have as much fun using it as I had 
writting it! -Paul Bradshaw 

LESAL NONSENSE 



DOTWRITER is a trademark of PR0S0FT, Box 560, N. Hollywood, CA 91603 
Yes, the DOTWRITER fonts included in this ARC file ARE PUBLIC DOMAIN! 
TR5TEXT2 is a copyright of Seorge Madison 

P0 Box 649 

Winchester, OR 77495 
TRSTEXT2 is based on an algorythm for decoding DOTWRITER fonts developed 
by Scott McBurnoy (S.MCBURNEY on GEnie) 



